Tools Plus for THINK Pascal and Tools Plus for THINK C are located in two separate folders. Tools Plus is made up of the following items:
“ToolsPlus.Lib1” First of two libraries needed to use Tools Plus
“ToolsPlus.Lib2” Second of two libraries needed to use Tools Plus
“ToolsPlus.h” C header file for Tools Plus
(C only)
“ToolsPlus.c” Source code for routines that must be compiled with
your application. These routines will be compiled
according to your project’s compiler settings for
680x0 processor and/or math co-processor
optimization.
(C only)
“ToolsPlus.p” Pascal interface file for Tools Plus
(Pascal only)
“Demos” Folder containing a demo application and its source
code
Installing Tools Plus for THINK C
`````````````````````````````````
This User Manual is also part of the Tools Plus package. Drag the ToolsPlus.Lib1 and ToolsPlus.Lib2 libraries into the C Libraries folder, and ToolsPlus.h into the Mac #includes folder, or where ever you keep your other libraries and header files. You can drag the ToolsPlus.c file into your C Libraries folder, even though it is not a library. Keeping it with the ToolsPlus.Lib1 and ToolsPlus.Lib2 libraries will help to remind you to include ToolsPlus.c in your project.
Adding Tools Plus to a THINK C Project
``````````````````````````````````````
To add Tools Plus to a THINK C project, first open your project, then use the Source menu’s Add… command to add the ToolsPlus.Lib1 and ToolsPlus.Lib2 libraries.
Put ToolsPlus.Lib1 in its own segment. It takes up almost the full 32k allowed per segment. Put ToolsPlus.Lib2 and ToolsPlus.c in a separate segment too. Although this second library is relatively small, it will likely become larger in future revisions of Tools Plus.
THINK C Compiler Options
````````````````````````
Warning: Tools Plus requires the use of standard 2-byte integers, and
not the optional 4-byte integers. Use the Edit menu’s Options…
command, and select “Compiler Settings.” Make sure the “4-byte
ints” check box is not selected.
Tools Plus Segments in THINK C
``````````````````````````````
The segments containing Tools Plus libraries will be constantly accessed while your application is running. It is preferable to pre-load those segments by flagging them as “Preload.”
Warning: Do not unload the segments containing Tools Plus libraries.
You can ensure that this doesn’t happen accidentally by
This User Manual is also part of the Tools Plus package. Drag the ToolsPlus.Lib1 and ToolsPlus.Lib2 libraries into the Libraries folder, and ToolsPlus.p into the Interface folder, or where ever you keep your other libraries and interfaces.
Adding Tools Plus to a THINK Pascal Project
```````````````````````````````````````````
To add Tools Plus to a project, first open your project, then use the Project menu’s Add File command to add the ToolsPlus.Lib1 and ToolsPlus.Lib2 libraries and the ToolsPlus.p interface file
Build Order…
ToolsPlus.Lib1 and ToolsPlus.Lib2 can be anywhere in your build
order, but for the sake of neatness, you decide to have all your
libraries in the same place, that being either at the top or bottom
of your build order list. ToolsPlus.p (the interface file) must
appear BEFORE any unit that makes reference to it. A good place it
somewhere before your first source code file.
By Segment…
Put ToolsPlus.Lib1 in a segment by itself. It takes up almost the
full 32k allowed per segment. Put ToolsPlus.Lib2 and ToolsPlus.p in
a separate segment too. Although this second library is relatively
small, it will likely become larger in future revisions of Tools
Plus.
After Compiling
```````````````
So far, you’ve told THINK Pascal what files to use and the order in which they should be compiled. When you compile your project the first time, THINK Pascal loads the specified libraries and integrates them into your project file, and it compiles source files (including ToolsPlus.p) and integrates them in your project file. After your first compile, you’ll notice that THINK Pascal automatically added several items to your project file:
«ToolsPlus.Lib1:1»
«ToolsPlus.Lib2:1»
«%_MethTables»
«%_SelProcs»
«%_Profiler»
The «ToolsPlus.Lib1:1» and «ToolsPlus.Lib2:1» items contain the object code from the Tools Plus libraries, while «%_MethTables», «%_SelProcs» and «%_Profiler» items are part of THINK Pascal’s overhead (consult your THINK Pascal User Manual for details).
Drag «ToolsPlus.Lib1:1» into the same segment as ToolsPlus.Lib1, and «ToolsPlus.Lib2:1» into the same segment as ToolsPlus.Lib2.
Drag «%_MethTables», «%_SelProcs» and «%_Profiler» to any segment that won’t be unloaded while your application is running, such as the one containing the Runtime.lib library.
Even though the project window indicates that Segment 1 exceeds the 32k limit imposed on segments, the project will compile and run. When you build your application, the smart linker will strip away unneeded code and significantly reduce the size of this segment.
Note: Tools Plus does not have a dependency on the Runtime.lib library.
Unless your application needs routines that are found only in the
full Runtime.lib library, you can use the smaller µRuntime.lib
library instead
Tools Plus Segments in THINK Pascal
```````````````````````````````````
The segments containing Tools Plus libraries will be constantly accessed while your application is running. It is preferable to pre-load those segments by flagging them as “Preload.”
Warning: Do not unload the segments containing Tools Plus libraries.
You can ensure that this doesn’t happen accidentally by
